Mention GtkEditable and entries in the migration guide

Not a very exhaustive treatment, but at least it gives
some hints.

diff --git a/docs/reference/gtk/migrating-3to4.xml b/docs/reference/gtk/migrating-3to4.xml
index 53e49c77b2986c546fb198f4fbdfdeb6417eb9e4..af5a689a6dc3644ccb88396631886b2b825e9ec1 100644 (file)
--- a/docs/reference/gtk/migrating-3to4.xml
+++ b/docs/reference/gtk/migrating-3to4.xml
@@ -601,6 +601,23 @@
         to pages. You can easily do that yourself.
       </para>
     </section>
+
+    <section>
+      <title>Adapt to changes in the API of GtkEntry and GtkSearchEntry</title>
+      <para>
+        The GtkEditable has been made more useful, and the core functionality of
+        GtkEntry has been broken out as a GtkText widget. GtkEntry, GtkSearchEntry,
+        GtkSpinButton and the new GtkPasswordEntry now use a GtkText widget internally
+        and implement GtkEditable. In particular, this means that it is no longer
+        possible to use GtkEntry API such as gtk_entry_grab_focus_without_selecting()
+        on a search entry.
+      </para>
+      <para>
+        Use GtkEditable API for editable functionality, and widget-specific APIs for
+        things that go beyond the common interface. For password entries, use
+        GtkPasswordEntry.
+      </para>
+    </section>
   </section>
 
 </chapter>